home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / BUS / A-E / AddStrip / Add_Strip 2.10 Docs next >
Encoding:
Text File  |  1988-01-18  |  7.9 KB  |  195 lines
  1. Add/Strip (version 2.10) Docs - Add/Strip 2.10 © 1987 Jon Wind
  2.                               - Please do not distribute modified copies
  3.                               - This file must be accompany Add/Strip 2.10
  4.                               - Source code available as shareware ($5-6)
  5.  
  6.  
  7. Files Included:
  8.  
  9. 1.  Add/Strip 2.10 Docs - This file. - Written using 9 point Monaco.
  10.  
  11. 2.  Add/Strip 2.10 - The application.  Do not rename.
  12.  
  13.  
  14.  
  15. Brief History:
  16.  
  17.  
  18. I wrote Add/Strip to improve our desktop publishing area’s productivity.  They
  19. use Aldus Pagemaker and Quark XPress (highly recommended) to produce some of
  20. our company’s shorter publications.  The copy is written on Wangs, CPTs,
  21. and/or DOS machines.  These text files are then sent to the Macs for page
  22. layout.  Unfortunately, these files are invariably formatted improperly for
  23. their needs.  Enter Add/Strip.
  24.  
  25. Version 2.10 of Add/Strip is the product of many hours of work.  As my
  26. knowledge of programming the Mac has increased, so has the complexity of this
  27. program.  It is free; my way of paying back for all of the other public domain
  28. programs I’ve had the pleasure of using.  Let me know what you think of it.
  29.  
  30.  
  31.  
  32. Commands:
  33.  
  34.  
  35. -->  See the online help for a complete description of current functions and
  36. limitations.
  37.  
  38. -->  Please note that ‘Strip CRs’ is NOT the same as ‘Make Paragraphs.’  Use
  39. ‘Make Paragraphs’ if you plan on importing the text file to a page layout or
  40. word processing program
  41.  
  42.  
  43. -->  Depending on which main function is currently selected, certain options
  44. may be disabled or defaulted.  The following table should help explain:
  45.  
  46.  
  47. Main Function          |Strip LFs |Leading |Trailing Spaces |Unhyphenate
  48. -----------------------+----------+--------+----------------+-----------
  49. Expand Tabs            |No        |Option  |Option          |No
  50. -----------------------|----------|--------|----------------|-----------
  51. Force Line Width       |Yes       |Strip   |Strip           |No
  52. -----------------------|----------|--------|----------------|-----------
  53. Read & Write File      |No        |Option  |Option          |No
  54. -----------------------|----------|--------|----------------|-----------
  55. Make Paragraphs        |Yes       |Option  |Option          |Yes
  56. -----------------------|----------|--------|----------------|-----------
  57. WordStar™ to Text      |Yes       |Option  |Option          |No
  58. -----------------------|----------|--------|----------------|-----------
  59. Replace Spaces w/ Tabs |No        |Option  |Option          |No
  60. -----------------------|----------|--------|----------------|-----------
  61. Add Characters         |No        |Option  |Option          |No
  62. -----------------------|----------|--------|----------------|-----------
  63. Strip Characters       |Option    |Option  |Option          |No
  64. -----------------------+----------+--------+----------------+-----------
  65.  
  66.  
  67.  
  68. 2.10 Changes:
  69.  
  70.  
  71. 1.  Added ability to edit the text file creator type (for output files) from
  72.     within the program.
  73.  
  74. 2.  Added ability to save and restore settings, in addition to the default
  75.     settings file.  Opening a configuration file from the Finder will load that
  76.     file’s settings, provided that the settings are in the proper format.
  77.     Add/Strip will attempt to load the default settings file (stored in the
  78.     system folder) if Add/Strip was NOT called by opening a config file from
  79.     the Finder, or that file’s settings are NOT in the proper format.  Files
  80.     created with an older version of Add/Strip will not load.
  81.  
  82. 3.  Added ability to select the maximum number of consecutive blank lines (0-3)
  83.     or ignore them entirely.
  84.  
  85. 4.  The ASCII characters chart (which uses a customized version of Geneva) can
  86.     now be accessed via the replace window or the menu.
  87.  
  88. 5.  Added a progress indicator bar to the processing window to visually
  89.     describe the amount of file processed/remaining.
  90.  
  91. 6.  Replaced the old ‘About…’ window with a scrollable help system.  It may be
  92.     accessed via command-? or the menu.  The Help key may be also used on the
  93.     extended keyboard.
  94.  
  95. 7.  Directional arrow keys (or > and < keys) may be used to control scrollbar
  96.     scrolling.  Command-arrow and command-< or command-> will effect a page up
  97.     or page down.  Page Up, Page Down, Home, and End keys may be used to
  98.     control scrollbar scrolling on the extended keyboard.
  99.  
  100. 8.  Cut, Copy, and Paste command key equivalents or function keys F2, F3, and
  101.     F4 on the extended keyboard will now work properly in text boxes.
  102.  
  103. 9.  The number of active replacement sets is now displayed on the ‘Get text…’
  104.     window in the form of Rn, where n is the number of ACTIVE sets.
  105.  
  106. 10. The text insertion point will be placed at the location of the first error
  107.     in the ‘Replace…’ window and, if possible, highlighting the error.
  108.  
  109. 11. Certain replacement strings should no longer cause the program to hang.
  110.  
  111. 12. The letters c, v, and x, are accepted properly in the replace window.
  112.  
  113. 13. Stripping or replacing leading spaces with a tab should now work properly.
  114.  
  115. 14. File processing may be aborted by holding down the command key and typing
  116.     a period.
  117.  
  118. 15. As a service to users, I’ve included a program called Strip Add/Strip 2.10,
  119.     which can reduce the size of your PERSONAL COPY of Add/Strip by a little
  120.     over 7K.  Please DO NOT distribute these modified copies to others.
  121.  
  122.  
  123.  
  124. Tips:
  125.  
  126.  
  127. 1.  Read the online help CAREFULLY.
  128.  
  129. 2.  Do not trash the original TEXT file until after verifying that Add/Strip
  130.     has done what was expected.
  131.  
  132. 3.  Be sure to verify ALL settings, including replacement strings, before
  133.     OKing to be sure that the correct processing will be done.
  134.  
  135. 4.  Use ResEdit to change the default file name in STR 1001 from ‘A/S Settings’
  136.     to something else if there is a name conflict in your system folder.
  137.  
  138. 5.  Set the Output File Creator type to another if you wish to launch a program
  139.     other than Add/Strip when you  double click on a file created by Add/Strip.
  140.     For instance, changing it to ‘MACA’ will provide launching into MacWrite.
  141.     Note that the file whose File Creator type you use must accept TEXT files.
  142.  
  143. 6.  Notify the author if you find a bug, or it may not get fixed.  See below.
  144.  
  145. 7.  If a Macintosh text file is going to be transferred to an DOS based
  146.     machine, it will probably require LFs after each line.  Therefore, it would
  147.     be appropriate to select the ‘Add LFs to paragraphs’ checkbox when ‘Make
  148.     paragraphs’ is chosen, or the ‘LFs’ checkbox when ‘Add characters’ is
  149.     chosen.  ‘Uncurl’ quotes and apostrophes should also be chosen.
  150.  
  151.     Note that lines of text on a Mac are generally terminated with a CR, while
  152.     DOS based machines use a CRLF sequence.  Keep this in mind when moving
  153.     files between the systems.
  154.  
  155. 8.  Consider processing a file two or more times to achieve the desired effect.
  156.     For instance, to replace all spaces greater than 2 in a file, first choose
  157.     the ‘Replace Spaces With Tabs’ function, setting the ‘Maximum allowable
  158.     spaces’ to 2.  Process the file.  Then, choose the ‘Expand Tabs’ function
  159.     and set the number of spaces to 0, or choose the ‘Read & Write File’
  160.     function and set one of the replacement sets to ‘Change #9 to <blank>’
  161.     (leave the second text box blank) and process the file that was output by
  162.     the first pass.
  163.  
  164. 9.  Because replacements are made blindly, use a word processor to do
  165.     conditional character replacement instead of Add/Strip.
  166.  
  167.  
  168.  
  169. Conclusion:
  170.  
  171.  
  172. Add/Strip works fine on my computer system.  I cannot (and do not) guarantee
  173. that it will on yours.
  174.  
  175. Add/Strip allows you to manipulate TEXT files in a number of ways.  This
  176. version is free, but I'll gladly accept ANY donation.  If you like it, have
  177. questions or suggestions, or find any bugs, I'd like to hear from you.  I can
  178. be reached at:
  179.  
  180. COMPUSERVE: 70167,3444
  181. GENIE: JPWIND
  182. MCIMAIL: JWIND
  183.  
  184.  
  185. If you don't have access to these services, or wish to register or obtain a
  186. copy of the source code (approx. 85K of commented Turbo Pascal), send a letter
  187. and $5 ($6 if I'm supplying the disk) to:
  188.  
  189. Jon Wind (A/S 2.10)
  190. 7180 Montrose Road
  191. Woodbury, MN  55125
  192.  
  193.  
  194. Thank you.
  195.